Modalità radio (SRA)

Il ricevitore MS2-Pro supporta tre modalità radio mutuamente esclusive (Single Radio Active):

  • SPP — Bluetooth Classic Serial Port Profile
  • BLE — Bluetooth Low Energy con servizio Nordic UART (NUS)
  • WIFI — solo WiFi, Bluetooth completamente disattivato

Solo una radio è attiva per volta. Per cambiare modalità è necessario un riavvio del ricevitore (~1.5 secondi). La scelta è persistente: dopo lo spegnimento il ricevitore riparte nell’ultima modalità selezionata.

Confronto modalità

Funzione SPP BLE WIFI
App Android/iOS ✓ via SPP ✓ via NUS —
Menu su Bluetooth ✓ +++ ✓ +++ —
Menu su TCP/socat — — ✓ porta 2947
NTRIP Client/Server ✓ (opt-in) ✓ (opt-in) ✓
PVT TCP server ✓ (opt-in) ✓ (opt-in) ✓ obbligo
MQTT publisher — — ✓
Heap libero stimato medio medio massimo
Soft AP fallback — — ✓

Casi d’uso tipici:

  • SPP: rover in campo con app GIS (Mapit, QField, SoluCAD) via cellulare
  • BLE: rover con app battery-conscious (BLE consuma meno del Classic)
  • WIFI: stazione fissa headless, base autonoma su tetto, accesso remoto via TCP, telemetria MQTT

Cambio modalità via pulsante (HOLD + COUNT)

Tieni premuto il pulsante power e conta i bip emessi dal buzzer:

0–1000 ms    silenzio        (rilascio = solo click feedback)
1000 ms      1 bip           ⇒ SPP
1700 ms      2 bip rapidi    ⇒ BLE
2400 ms      3 bip rapidi    ⇒ WIFI
>3500 ms     bip discendente ⇒ POWER OFF

Rilascia il pulsante quando senti il numero di bip corrispondente alla modalità desiderata. Il ricevitore si riavvia automaticamente.

Tutti i bip a 1500 Hz, 80 ms — distinguibili come ritmo (singolo / doppio / triplo).

Il LED del pulsante lampeggia in sincrono ai bip, utile in ambienti rumorosi o se hai cuffie/casco.

Al rilascio non viene emesso nessun suono di conferma: il pattern audio finale arriva al boot della nuova modalità (vedi sotto).

Pattern audio al boot

Quando il ricevitore parte (sia da reset, sia dopo cambio modalità), emette un pattern che identifica la modalità attiva:

Modalità Pattern audio al boot
SPP 1 beep lungo grave (800 Hz, 500 ms)
BLE 2 beep corti medi (1500 Hz, 120 ms ciascuno)
WIFI 3 toni ascendenti (1500/2000/2500 Hz)

Cambio modalità via menu

In alternativa al pulsante, puoi cambiare modalità dal menu:

  1. Apri il menu (+++ dopo aver connesso al ricevitore)

  2. Premi [t] Radio — appare il sotto-menu:

    === Radio (SRA) ===

Current: WIFI

[1] SPP (BT + NTRIP + PVT)
[2] BLE (BT + NTRIP + PVT)
[3] WIFI (no BT, NTRIP + PVT)
[x] Annulla

  3. Premi il numero della modalità (1/2/3) — il ricevitore conferma e si riavvia in 1.5 secondi.

Cleanup automatico al cambio modalità

Prima del riavvio, il firmware effettua un cleanup ordinato di tutte le connessioni di rete attive:

  • Chiusura PVT TCP server (FIN ai client, Connection closed lato peer)
  • Last-will retained MQTT {"alive":false}
  • Chiusura graceful NTRIP Client/Server
  • Flush dei buffer SD

Risultato: niente client/peer rimasti in attesa di timeout dopo il cambio modalità.

Flag «Keep NTRIP/MQTT on mode switch»

Per default il cambio modalità radio resetta lo stato dei servizi di rete (NCLI/NSER/MQTT vengono disattivati, ricevitore riparte come Rover standalone).

Se preferisci che lo stato venga mantenuto attraverso il cambio modalità, attiva il flag dal menu [w] Network → [K] Keep NTRIP/MQTT on mode switch:

  • Off (default): cambio radio = boot pulito Rover, devi riattivare manualmente NTRIP/MQTT nella nuova modalità.
  • On: lo stato persistente è preservato, NCLI/NSER/MQTT ripartono automaticamente.

Il flag è visibile solo in modalità WIFI.

Soft AP fallback (solo in modalità WIFI)

Se il ricevitore è in WIFI mode e non ha SSID configurato (SSID NVS vuoto, condizione tipica out-of-the-box o dopo [w][c] Clear all), avvia automaticamente un Soft Access Point sul proprio MAC:

  • SSID: MS2-<12 hex MAC> (es. MS2-AC1518EDCB22)
  • Auth: aperta, no password
  • Canale: 6
  • IP statico: 192.168.4.1
  • Max 2 client simultanei
  • DHCPS attivo sul ricevitore
  • Menu accessibile via socat - TCP:192.168.4.1:2947 dopo connessione al SSID

Utile per la prima configurazione WiFi del ricevitore senza dover ricorrere a SPP/BLE.

Nota

Il Soft AP non viene attivato in caso di SSID configurato ma irraggiungibile/password errata: in quello scenario il WiFi STA continua a ritentare la connessione. Per forzare l’AP fallback usa [w][c] Clear all (cancella SSID e password) e riavvia.